<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>add_image [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_filters.html">过滤器</a> / <a href="toc_filters_arithmetic.html">算术</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">add_image</span><span data-if="c" style="display:none;">add_image</span><span data-if="cpp" style="display:none;">AddImage</span><span data-if="dotnet" style="display:none;">AddImage</span><span data-if="python" style="display:none;">add_image</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">add_image</span><span data-if="c" style="display:none;">add_image</span><span data-if="cpp" style="display:none;">AddImage</span><span data-if="dotnet" style="display:none;">AddImage</span><span data-if="python" style="display:none;">add_image</span></code> — 两幅图像相加。</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>add_image</b>(<a href="#Image1"><i>Image1</i></a>, <a href="#Image2"><i>Image2</i></a> : <a href="#ImageResult"><i>ImageResult</i></a> : <a href="#Mult"><i>Mult</i></a>, <a href="#Add"><i>Add</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>add_image</b>(const Hobject <a href="#Image1"><i>Image1</i></a>, const Hobject <a href="#Image2"><i>Image2</i></a>, Hobject* <a href="#ImageResult"><i>ImageResult</i></a>, double <a href="#Mult"><i>Mult</i></a>, double <a href="#Add"><i>Add</i></a>)</code></p>
<p>
<code>Herror <b>T_add_image</b>(const Hobject <a href="#Image1"><i>Image1</i></a>, const Hobject <a href="#Image2"><i>Image2</i></a>, Hobject* <a href="#ImageResult"><i>ImageResult</i></a>, const Htuple <a href="#Mult"><i>Mult</i></a>, const Htuple <a href="#Add"><i>Add</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>AddImage</b>(const HObject&amp; <a href="#Image1"><i>Image1</i></a>, const HObject&amp; <a href="#Image2"><i>Image2</i></a>, HObject* <a href="#ImageResult"><i>ImageResult</i></a>, const HTuple&amp; <a href="#Mult"><i>Mult</i></a>, const HTuple&amp; <a href="#Add"><i>Add</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>AddImage</b>(const HImage&amp; <a href="#Image2"><i>Image2</i></a>, const HTuple&amp; <a href="#Mult"><i>Mult</i></a>, const HTuple&amp; <a href="#Add"><i>Add</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>AddImage</b>(const HImage&amp; <a href="#Image2"><i>Image2</i></a>, double <a href="#Mult"><i>Mult</i></a>, double <a href="#Add"><i>Add</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>AddImage</b>(<a href="HObject.html">HObject</a> <a href="#Image1"><i>image1</i></a>, <a href="HObject.html">HObject</a> <a href="#Image2"><i>image2</i></a>, out <a href="HObject.html">HObject</a> <a href="#ImageResult"><i>imageResult</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mult"><i>mult</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Add"><i>add</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>AddImage</b>(<a href="HImage.html">HImage</a> <a href="#Image2"><i>image2</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mult"><i>mult</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Add"><i>add</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>AddImage</b>(<a href="HImage.html">HImage</a> <a href="#Image2"><i>image2</i></a>, double <a href="#Mult"><i>mult</i></a>, double <a href="#Add"><i>add</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>add_image</b>(<a href="#Image1"><i>image_1</i></a>: HObject, <a href="#Image2"><i>image_2</i></a>: HObject, <a href="#Mult"><i>mult</i></a>: Union[int, float], <a href="#Add"><i>add</i></a>: Union[int, float]) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">add_image</span><span data-if="c" style="display:none">add_image</span><span data-if="cpp" style="display:none">AddImage</span><span data-if="com" style="display:none">AddImage</span><span data-if="dotnet" style="display:none">AddImage</span><span data-if="python" style="display:none">add_image</span></code> adds two images.  The gray values
(g1,g2) of the input images (<a href="#Image1"><i><code><span data-if="hdevelop" style="display:inline">Image1</span><span data-if="c" style="display:none">Image1</span><span data-if="cpp" style="display:none">Image1</span><span data-if="com" style="display:none">Image1</span><span data-if="dotnet" style="display:none">image1</span><span data-if="python" style="display:none">image_1</span></code></i></a> and
<a href="#Image2"><i><code><span data-if="hdevelop" style="display:inline">Image2</span><span data-if="c" style="display:none">Image2</span><span data-if="cpp" style="display:none">Image2</span><span data-if="com" style="display:none">Image2</span><span data-if="dotnet" style="display:none">image2</span><span data-if="python" style="display:none">image_2</span></code></i></a>) are transformed as follows:
<span class="pre">
                g' := (g1 + g2) * Mult + Add
</span>
</p>
<p>If an overflow or an underflow occurs the values are clipped.
Note that this is not the case with cyclic and direction images.
The resulting image is stored in <a href="#ImageResult"><i><code><span data-if="hdevelop" style="display:inline">ImageResult</span><span data-if="c" style="display:none">ImageResult</span><span data-if="cpp" style="display:none">ImageResult</span><span data-if="com" style="display:none">ImageResult</span><span data-if="dotnet" style="display:none">imageResult</span><span data-if="python" style="display:none">image_result</span></code></i></a>.
</p>
<p>
It is possible to add byte images with int2, uint2 or int4 images and to add
int4 to int2 or uint2 images. In this case the result will be of type int2 or
int4 respectively.
</p>
<p>
Several images can be processed in one call. In this case
both input parameters contain the same number of images
which are then processed in pairs.
An output image is generated for every pair.
</p>
<p>Please note that the runtime of 该算子 varies with different
control parameters. For frequently used combinations special
optimizations are used. Additionally, for byte, int2, uint2, and int4
images special optimizations are implemented that use SIMD technology.
The actual application of these special optimizations is controlled by the
system parameter <i><span data-if="hdevelop" style="display:inline">'mmx_enable'</span><span data-if="c" style="display:none">"mmx_enable"</span><span data-if="cpp" style="display:none">"mmx_enable"</span><span data-if="com" style="display:none">"mmx_enable"</span><span data-if="dotnet" style="display:none">"mmx_enable"</span><span data-if="python" style="display:none">"mmx_enable"</span></i> (see <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system</span><span data-if="c" style="display:none">set_system</span><span data-if="cpp" style="display:none">SetSystem</span><span data-if="com" style="display:none">SetSystem</span><span data-if="dotnet" style="display:none">SetSystem</span><span data-if="python" style="display:none">set_system</span></code></a>).
If <i><span data-if="hdevelop" style="display:inline">'mmx_enable'</span><span data-if="c" style="display:none">"mmx_enable"</span><span data-if="cpp" style="display:none">"mmx_enable"</span><span data-if="com" style="display:none">"mmx_enable"</span><span data-if="dotnet" style="display:none">"mmx_enable"</span><span data-if="python" style="display:none">"mmx_enable"</span></i> is set to <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i> (and the SIMD
instruction set is available), the internal calculations are performed
using SIMD technology.
</p>
<p><code><span data-if="hdevelop" style="display:inline">add_image</span><span data-if="c" style="display:none">add_image</span><span data-if="cpp" style="display:none">AddImage</span><span data-if="com" style="display:none">AddImage</span><span data-if="dotnet" style="display:none">AddImage</span><span data-if="python" style="display:none">add_image</span></code> can be executed on an OpenCL device for byte, int1, int2,
uint2, int4, real, direction, cyclic, and complex images. However, since
for OpenCL 1.0 only single precision floating point is supported for all
devices, and not all rounding modes are supported, the OpenCL implementation
can produce slightly different results from the scalar or SIMD
implementations.
</p>
<h2 id="sec_attention">注意</h2>
<p>Note that the acceleration gained by SIMD technology is highest on large,
compact input regions. However, in rare cases, the execution of <code><span data-if="hdevelop" style="display:inline">add_image</span><span data-if="c" style="display:none">add_image</span><span data-if="cpp" style="display:none">AddImage</span><span data-if="com" style="display:none">AddImage</span><span data-if="dotnet" style="display:none">AddImage</span><span data-if="python" style="display:none">add_image</span></code>
might take significantly longer with SIMD technology than without,
depending on the input region and the capabilities of
the hardware. In these cases, the use of SIMD
technology can be avoided by <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'mmx_enable','false':)</span><span data-if="c" style="display:none">set_system("mmx_enable","false")</span><span data-if="cpp" style="display:none">SetSystem("mmx_enable","false")</span><span data-if="com" style="display:none">SetSystem("mmx_enable","false")</span><span data-if="dotnet" style="display:none">SetSystem("mmx_enable","false")</span><span data-if="python" style="display:none">set_system("mmx_enable","false")</span></code></a>.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
    
      <li>支持OpenCL计算设备。</li>
    
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
    <li>在图像通道级别自动并行化。</li>
    <li>Automatically parallelized on  domain level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image1" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image1</span><span data-if="c" style="display:none">Image1</span><span data-if="cpp" style="display:none">Image1</span><span data-if="com" style="display:none">Image1</span><span data-if="dotnet" style="display:none">image1</span><span data-if="python" style="display:none">image_1</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*)<i> *allowed for compute devices</i></span>
</div>
<p class="pardesc">Image(s) 1.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Image2" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image2</span><span data-if="c" style="display:none">Image2</span><span data-if="cpp" style="display:none">Image2</span><span data-if="com" style="display:none">Image2</span><span data-if="dotnet" style="display:none">image2</span><span data-if="python" style="display:none">image_2</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte* / int1* / int2* / uint2* / int4* / int8 / real* / direction* / cyclic* / complex*)<i> *allowed for compute devices</i></span>
</div>
<p class="pardesc">Image(s) 2.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageResult" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageResult</span><span data-if="c" style="display:none">ImageResult</span><span data-if="cpp" style="display:none">ImageResult</span><span data-if="com" style="display:none">ImageResult</span><span data-if="dotnet" style="display:none">imageResult</span><span data-if="python" style="display:none">image_result</span></code></b> (output_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte / int1 / int2 / uint2 / int4 / int8 / real / direction / cyclic / complex)</span>
</div>
<p class="pardesc">Result image(s) by the addition.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Mult" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Mult</span><span data-if="c" style="display:none">Mult</span><span data-if="cpp" style="display:none">Mult</span><span data-if="com" style="display:none">Mult</span><span data-if="dotnet" style="display:none">mult</span><span data-if="python" style="display:none">mult</span></code></b> (input_control)  </span><span>number <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Factor for gray value adaption.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0.5</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0.2, 0.4, 0.6, 0.8, 1.0, 1.5, 2.0, 3.0, 5.0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>-255.0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Mult</span>
    <span data-if="c" style="display:none">Mult</span>
    <span data-if="cpp" style="display:none">Mult</span>
    <span data-if="com" style="display:none">Mult</span>
    <span data-if="dotnet" style="display:none">mult</span>
    <span data-if="python" style="display:none">mult</span>
    
          ≤
          255.0</code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>0.001</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>0.1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Add" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Add</span><span data-if="c" style="display:none">Add</span><span data-if="cpp" style="display:none">Add</span><span data-if="com" style="display:none">Add</span><span data-if="dotnet" style="display:none">add</span><span data-if="python" style="display:none">add</span></code></b> (input_control)  </span><span>number <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Value for gray value range adaption.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 64, 128, 255, 512</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>-512.0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Add</span>
    <span data-if="c" style="display:none">Add</span>
    <span data-if="cpp" style="display:none">Add</span>
    <span data-if="com" style="display:none">Add</span>
    <span data-if="dotnet" style="display:none">add</span>
    <span data-if="python" style="display:none">add</span>
    
          ≤
          512.0</code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>0.01</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1.0</p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
add_image(Image1,Image2,Result,0.5,10.0)
dev_display (Result)
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
read_image(&amp;Image1,"fabrik");
disp_image(Image1,WindowHandle);
read_image(&amp;Image2,"monkey");
disp_image(Image2,WindowHandle);
add_image(Image1,Image2,&amp;Result,0.5,10.0);
disp_image(Result,WindowHandle);
</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
add_image(Image1,Image2,Result,0.5,10.0)
dev_display (Result)
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
add_image(Image1,Image2,Result,0.5,10.0)
dev_display (Result)
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
read_image(Image1,'fabrik')
dev_display (Image1)
read_image(Image2,'monkey')
dev_display (Image2)
add_image(Image1,Image2,Result,0.5,10.0)
dev_display (Result)
</pre>
</div>
<h2 id="sec_result">结果</h2>
<p>如果参数都是正确的，该算子 <code><span data-if="hdevelop" style="display:inline">add_image</span><span data-if="c" style="display:none">add_image</span><span data-if="cpp" style="display:none">AddImage</span><span data-if="com" style="display:none">AddImage</span><span data-if="dotnet" style="display:none">AddImage</span><span data-if="python" style="display:none">add_image</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)。
The behavior in case of empty input (no
input images available) is set via 该算子
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'no_object_result',&lt;Result&gt;:)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>
If necessary an exception is raised.</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="sub_image.html"><span data-if="hdevelop" style="display:inline">sub_image</span><span data-if="c" style="display:none">sub_image</span><span data-if="cpp" style="display:none">SubImage</span><span data-if="com" style="display:none">SubImage</span><span data-if="dotnet" style="display:none">SubImage</span><span data-if="python" style="display:none">sub_image</span></a></code>, 
<code><a href="mult_image.html"><span data-if="hdevelop" style="display:inline">mult_image</span><span data-if="c" style="display:none">mult_image</span><span data-if="cpp" style="display:none">MultImage</span><span data-if="com" style="display:none">MultImage</span><span data-if="dotnet" style="display:none">MultImage</span><span data-if="python" style="display:none">mult_image</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="sub_image.html"><span data-if="hdevelop" style="display:inline">sub_image</span><span data-if="c" style="display:none">sub_image</span><span data-if="cpp" style="display:none">SubImage</span><span data-if="com" style="display:none">SubImage</span><span data-if="dotnet" style="display:none">SubImage</span><span data-if="python" style="display:none">sub_image</span></a></code>, 
<code><a href="mult_image.html"><span data-if="hdevelop" style="display:inline">mult_image</span><span data-if="c" style="display:none">mult_image</span><span data-if="cpp" style="display:none">MultImage</span><span data-if="com" style="display:none">MultImage</span><span data-if="dotnet" style="display:none">MultImage</span><span data-if="python" style="display:none">mult_image</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
